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METHOD OF SYKCHR0HXZXN6 ZMDEFEMDENTLY DISTRIBOTED 
SOFTWARE AND DATABASE SCHEMA 



IKTRODPCTIOM 

I .Technical Field 

This invention relates to a system and method for providing updates to 
10 a network of partially replicated relational database systems, and, 
more particularly, for providing am efficient means for con?)uting the 
visibility to a client on the network of a transaction processed 
against the database . 

15 II. Backqroiind 

Relational dateibases are a commonly- en^jloyed data structure for 
representing data in a business or other environment. A relational 
database represents data in the form of a collection of two-dimensional 
tables. Each table con^rises a series of cells arranged in rows and 
20 columns. Typically, a row in a table represents a particular 
observation. A column represents either a data field or a pointer to 
a row in another table . 

For example, a datedjase describing an organizational structure 

25 may have one table to describe each position in the organization, cuid 
another table to describe each employee in the organization. The 
enployee tc±ile may include information specific to the en?)loyee, such 
as name, employee number, age, salary, etc. The position table may 
include information specific to the position, such as the position 

30 title ("salesman", "vice president", etc.), a salary range, and the 
like. The tables may be related by, for exan^le, providing in each row 
of the en^loyee table a pointer to a particular row in the position 
table, coordinated so that, for each row in the employee table, there 
is a pointer to the particular row in the position tahle that describes 

35 that en^jloyee's position. A relational database management system 
(RDBMS) supports "joining" these tables in response to a query from a 
user, so that the user making a query about, for exan^jle, a particular 
enployee, may be provided with a report of the selected employee, 
including not only the information in the enployee table, but also the 

40 information in the related position taOale. 

Relational databases may be much more complex them this example, 
with several tables and a multiplicity of relations among them. 
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With the widespread use o£ inexpensive portable conqputers, it is 
advemtageous to replicate a database onto a portable con^juter for 
reference at locations remote from the central computer. The 
replicated database may then be referenced by the user of the portsLble 
computer, without requiring reference to the main database, which may 
be maintained at a central location inconvenient to the user of the 
portable computer. However, there are a number of difficulties with 
the use of a replicated database. 

One disadvcuitage is that a full copy of the central database may 
require more data storage than is desired or economical. For example, 
a salesman working in the field may need to refer to the database for 
information regarding sales opportunities in his sales area, but have 
no need to refer to any information regarding sales opportxinities 
outside of his area. One possible approach to reduce the amotint of 
required data storage is to siit^jly replicate only that portion of the 
dataljase that is needed by the user. However, this approach does not 
recognize that the criteria to determine which portions of the data are 
required is likely to vary over time. For example, the salesman may 
have a new city added to his territory. Under conventional approaches, 
the salesman would need to re-replicate his local copy of the dateibase, 
this time selecting data including the added city. Such a practice is 
inconvenient, subject to error, and time-consuming. 

A further disadvantage to a replicated database is the 
difficulties encoxmtered in attempting to update data using the 
replicated copy. A change made to the replicated database is not made 
to the central database, leading to a discrepancy between the 
information that is stored in the replicated copy of the database and 
the information that is stored in the central database. Although it is 
possible to journal modifications made to the replicated copy and apply 
an identical modification to the central database, one problem that 
this approach faces is the possibility of colliding updates; that is, 
where a user of a replicated copy makes a change to data that is also 
changed by a user of the central copy or by the user of another 
replicated copy. 

It is therefore desirable to provide a capability to maintain one 
or more partially- replicated copies of a central database, in such a 
way that the degree of replication may be easily changed without 
requiring a refresh of the entire replicated database, and that permits 
updates to be coordinated among users of the central database and users 
of the partially replicated databases. 

SUMMARY OF THE IMVEMTION 

-2- 
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The present invention is directed to a method of maintaining a 
partially replicated database in such a way that updates made to a 
central dateUsase, or to emother peurtially replicated database, are 
selectively propagated to the partially replicated database, l^dates 
5 are propagated to a partially replicated database if the owner of the 
partially replicated database is deemed to have visibility to the data 
being updated. Visibility is determined by use of predetermined rules 
stored in a rules database. In one aspect of the invention, the stored 
rules are assessed against data content of various tables that make up 
10 a logical entity, known as a docking object, that is being updated. 

In another aspect of the invention, the stored rules are assessed 
against data content of one or more docking objeicts that are not 
necessarily updated, but that are related to a docking object being 
15 updated, in one embodiment, the visibility attributes of the related 
docking objects are recursively determined. 

In yet another aspect of the invention, changes in visibility are 
determined to eneJale the central computer to direct the nodes to insert 
20 the docking object into its pcortially replicated database. Such 
chcingeB in visibility are determined so as to enable the central 
con?)uter to direct a node to remove a docking object from its partially 
replicated database. 

In a further aspect of the invention, the predetermined rules are 
25 in declarative form and specify visibility of data based upon structure 
of the data without reference to data content. 

In still another aspect of the invention, the levels of the 
datoOsase schema cind the datoibase access software are synchronized to 
prevent an updated schema from being processed by a back- level version 
30 of software. 

A still further aspect of our invention is a method of 
upgrading a software application from one or more upgrade package 
files in a server (1) to a client (21a, 21b, 21c) . According to this 

35 method a copy of the upgrade package files and an upgrade database 
table are created on the server (l) . A pointer is created in the 
client's (21a, 21b, 21c) file on the server (1). This pointer points 
to the upgrade package files on the server (l) . In invoking the 
upgrade the, the upgrade files are made active, and the upgrade 

40 database tahle is scanned when a client (21a, 21b, 21c) docks. This 
is to determine the status of am upgrade with respect to the 
particular client (21a, 21b, 21c) . The v^jgrade is copied to the 
client (21a, 21b, 21c) if the client (21a, 21b, 21c) has not received 
the upgrade. At this point the upgrade may be invoked at the client 

45 (21a, 21b, 21c) . 
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A Still further aspect of our invention is a program product 
article of manufacture encon^assing a cozr^uter usable medixjm with 
computer program code embodied therein for causing the upgrading of a 
software application from upgrade package files in a server (l) to a 
client (21a, 21b, 21c) . The computer readable program in the program 
product article of manufacture contains computer readeOsle program 
code means for causing a con^juter to effect creating a copy of the 
upgrade package files on the server (1) , creating an upgrade database 
teible on the server (1); creating a pointer in the client's (21a, 
21b, 21c) file on the server (1) pointing to the upgrade package 
files on the server (1) , making the upgrade active, scanning the 
upgrade database table when a client (21a, 2lb, 21c) docks to 
determine the status of eui upgrade with respect to the client (21a, 
21b, 21c) , copying the upgrade to a client (21a, 21b, 21c) if the 
client (21a, 21b, 21c) has not received the upgrade, and invoking the 
upgrade at the client (21a, 21b, 21c) . 

A even further aspect of our invention is a program product in 
the form of a program storage device readable by a machine, tangibly 
embodying a program of instructions executable by a machine to 
perform method steps for of upgrading a software application from 
upgrade package files in a server (1) to a client (21a, 21b, 21c) 
said method steps coiqprising creating a copy of the upgrade package 
files on the server (1) , creating an upgrade database table on the 
server (1); creating a painter in the client's (21a, 21b, 21c) file 
on the server (1) pointing to the upgrade package files on the server 

(1) , making the upgrade active, scanning the upgrade database table 
when a client (21a, 21b, 21c) docks to determine the status of an 
upgrade with respect to the client (21a, 21b, 21c) , copying the 
upgrade to a client (21a, 21b, 21c) if the client (21a, 21b, 21c) has 
not received the upgrade, and invoking the upgrade at the client 

(21a, 21b, 21c) . 

BRIEF DESCRIPTION OF THE DRAWINGS 
Figure 1 depicts an overview of the operation of one embodiment 
of the present invention. 

Figure 2 depicts a database schema that shows the relationship of 
the various con^jonents that make up a Docking Object. 

Figure 3 depicts steps performed by an update manager to update 
a database. 

Figure 4 depicts steps performed by a Docking Manager to transmit 
and/or receive one or more transaction logs. 
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Figure 5 depicts the steps performed by a merge processor to 
merge transaction log records into an existing database. 

Figure 6 depicts the steps performed by a log manager to prepeure 
5 a partial transaction log. 

Figure 7 depicts the steps performed by a visibility calculator 
for calculating visibility for a docking object as invoked by a log 
manager . 

10 

Figure 8 depicts the steps performed to synchronize a partially 
replicated database in response to a change in data visibility. 

DESCRIPTIOK OP S PECIFIC EMBODIMEMTS 

Oveirvlew 

15 Figure 1 depicts an overview of the operation of one embodiment 

of the present invention. Figure 1 depicts a central conqjuter system 
1 and three remote computer systems (or "nodes") 21-a, 21-b, eind 21-c. 
Each of nodes 21-a, 21-b and 21-c are depicted in various states of 
communication with central computer system 1, as will be more fully 

20 e^qjlained. Central computer system 1 includes a central database 3, a 
docking msuiager 5 , a merge processor 7 and a log manager 9 . Central 
conputer system 1 additionally optionally includes update manager 11 
responsive to user input 13 . 

25 Node 21-a is a remote computer system, such as a mobile client 

such as a laptop computer. Node 21-a includes a partially replicated 
remote dateibase 23 -a, update manager 31 -a responsive to user input 33- 
a, docking manager 25 -a and merge manager 27 -a. In operation, update 
manager is responsive to user input 33 -a to make changes to remote 

30 database 23 -a as directed by the operator of node 21-a. Updates made 
are recorded, or joumaled, in node update log 35 -a. 

At some point at the convenience of the operator of node 21-a, 
node docking msuiager 35 -a is activated, and enters into communication 

35 with central docking manager 5. Update log 35 -a is tsdcen as input by 
node docking manager 25 -a, and provided to central docking manager 5. 
Central docking manager 5 creates a received node update log 19, which 
contains all the information that had been recorded in update log 35 -a. 
Optionally, peurtial log 17 -a is taken as input by central docking 

40 manager 5 and provided to node docking manager 25 -a, as more fully 
described herein. 

At SOTie point in time, at the convenience of the operator of 
central con^uter system 1, merge processor 7 is activated. Merge 
45 processor 7 takes as ii^ut received node update log 19, euid applies the 

-5- 
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updates described therein to central database 3 . In the process of 
applying the updates £rom received node update log 19, merge processor 
journals the updates applied to central update log 15. Optionally, 
update manager 11, responsive to user input 12 makes additional changed 
to central database 3 as directed by the operator of central computer 
system 1. The updates made by update manager 11 are additionally 
j oumaled in central update log 15 . 

At some point in time, at the convenience of the operator of 
central computer system 1, log manager 9 is activated. Log manager 9 
takes as input central update log 15 cuid produces as output a set of 
partial logs 17 -a, 17 -b and 17 -c according to visibility rules as will 
be further described herein. Each of partial logs 17-a, 17-b euid 17-c 
corresponds to one of nodes 21 -a, 2l-b and 21 -c. When a node docking 
manager such as node docking manager 25 -a enters into communication 
with central docking msinager 5 and optionally requests transmission of 
its corresponding partial log, central docking manager 5 takes as input 
the appropriate partial log, such as partial log 17-a, and presents it 
to node docking meuiager 25-a. Node docking manager 25-a then 
replicates partial log 17-a as merge log 37-a. 

At some point in the future, at the convenience of the operator 
of node 21-a, 

merge processor 27-a is activated. Merge processor 27-a takes as input 
merge log 37-a, and applies the updates described therein to partially 
replicated database 23 -a. 

In addition to node 21-a, Figure 1 also depicts two additional 
nodes 21 -b and 21 -c. Node 21 -b is depicted in communication with 
central computer 1. However, unlike node 21-a, the operator of node 
21 -b has requested only to send his updates to central computer system 
1, and has not requested to be presented with changes made elsewhere to 
be made to his partially replicated database 23 -b. This may be, for 
example, if the operator has an urgent update that must be made as soon 
as possible, but does not have the time to receive updates from other 
nodes. Accordingly, Figure 1 shows only transmission of node update 
log 35 -a from node docking manager 25 -b to central docking manager 5, 
and no transmission from central docking msuiager 5 to node docking 
meuiager 25 -b. Accordingly, the merge manager for node 21 -b is not 
activated and is not shown. 

Likewise, node 21-c is depicted as not in communication with 
central computer system 1. Accordingly, the docking manager for node 
21-c is not activated and is not shown. 

-6- 
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By the cycle described above, updates made by each of nodes 21 -a, 
21-b and 21-c eure presented to central cot^juter system l, permitting 
central database 3 to be updated accordingly. In addition, each of the 
updates made by each of the nodes 21-a, 21-b and 21-c, as well as 
5 updates made on central conputer system 1, are routed back to each of 
nodes 21-a, 21-b, and 21-c, thereby keeping each of partial databases 
23 -a, 23 -b and 23 -c in synchronization with each other and with central 
database 3 . 

10 Databaaa Struetxire 

The synchronization of central database 3 with node databases 23- 
a, 23 -b and 23 -c is performed using a construct called a Docking 
Object. A Docking Object consists of Member Tables (including one 
Primary Table) , Visibility Rules, Visibility Events, and related 

15 Docking Objects. 

A Member Table is a table of the relational database that makes 
up a docking object. When a docking object is propagated from central 
database 3 to one of node databases 23-a, 23-b or 23-c, the propagation 

20 takes the form of an insertion into each of the Member Tables 
associated with the particular docking object. Similarly, when a 
docking object is scheduled to be removed from a database, that removal 
consists of deleting records from the member tcOsles associated with the 
docking object. For example, a docking object that represents a sales 

25 opportunity may include tables that represent the opportunity itself 
(e.g., named "S_OPTy"), the product whose sale is represented by the 
opportunity (e.g., named "S_OPTY_PR0D'') , the contact for the 
opportunity (e.g., named "S_OPTY_C0OTACT" ) , etc. Each of these tables 
is said to be a member table of the "Opportunity Docking Object." 

30 

A Primary Table is a Member Table that controls whether a 
particular instance of a Docking Object is visible to a particular 
node. The Primary Tedsle has a Primary Row-ID value that is used to 
identify a row of the Primary Table being updated, deleted or inserted. 
35 For exanple, the "Opportunity Docking Object" may have as a primary 
teOale the table S_OPTY. The row- id of that table, i.e., S_OPTY.row_id, 
is the Primary Row- ID for the Opportianity Docking Object. 

A Visibility Rule is a criterion that determines whether a 
40 particular instance of a Docking Object is "visible" to a particular 
node 21. If a Docking Object is visible to a particular node, that 
node will receive updates for data in the Docking Object. Visibility 
Rules are of two types, depending on the field RDLE_TypE. A Visibility 
Rule with a KCn.E_TyPE of "R" is referred to as an SQL Rule. An SQL 
45 Rule includes a set of Structured Query Language (SQL) statements that 
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is evaluated to determine if any data meeting the criteria specified in 
the SQL statements exists in the Docking Object. If so, the Docking 
Object is visible to the node. A Visibility Rule with a RDLE_TYPE of 
"O" is referred to as a Docking Object Rule. A Docking Object Rule 
specifies cuiother Docking Object to be queried for visibility. If the 
specified Docking Object is visible, then the Docking Object pointing 
to it is also visible. 

A Related Docking Object is a Docking Object that is propagated 
or deleted when the Docking Object under consideration is propagated or 
deleted. For example, an Opport\inity Docking Object may have related 
Docking Objects representing the sales contacts, the organizations, the 
products to be sold, and the activities needed to pursue the 
opportunity. When an Opportunity Docking Object is propagated from 
Central Database 3 to one of node datsQiases 23, the related docking 
objects are also propagated. 

Figure 2 depicts a database schema that shows the relationship of 
the various components that make up a Docking Object. The schema is a 
meta- database, in that it does not describe the data being accessed in 
the database . Rather, the schema is a separate datcibase that defines 
the structure of the datcibase being accessed. That is, it is a 
database comprising tables that describe the relationships and data 
contexts of another database. 

Each of the tallies shown in Figure 2 is a table in a relational 
database, and as such is in row- column form. Meuiy colimns represent 
fields that are common to all the illustrated tables. Such fields 
include for exan^le, a ROW_ID to identify a particular row in the 
taible, as well as fields to tack the date and time that a row was 
created and last modified, and the identity of the user who created or 
modified the row. In addition, each table contains fields specific to 
that table, and which are described in detail below. 

Table S_DOBJ SI describes the Docking Objects in an application. 
Table S_DOBJ 61 includes the fields OBJ_NAME and PRIMARY_TABLE_ID . 
Field OBJ_NAME defines the name of the Docking Object being described. 
Field PRIMARY_TABLE_ID is used to identify the primary table associated 
with this Docking Object. 

Table S_DOBJ_INST 63 describes whether a particular instance of 
a Docking Object, described by tsQsle S_DOBJ 61, is present on a 
particular node's datzibase. Table S_DOBJ_INST 63 includes the fields 
NODE_ID, DOBJ_ID and PR_TBL_ROW_lD . Field NODE_ID points to a 

particular node table 65. Field DOBJ_ID points to the Docking Object 
to which the Docking Object instance applies. Field PR_TBL_ROW_ID is 

-8- 
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used to select a particular row in the Primary Table of the Docking 
Object. This value identifies the Docking Object instance. 

Table S_HEL_DOBJ 67 describes the related Docking Objects of a 
5 particular Docking Object, described by table S_DOBJ 61. Table 
S_REL_DOBJ G7 includes the fields DOBJ_ID, REL_DOBJ_ID, and 
SQL_STATEMEliJT. Field DOBJ_ID identifies the Docking Object that owns 
a particular related Docking Object. Field REL_DOBJ_ID identifies the 
related Docking Object that is owned by the Docking Object identified 
10 by DOBJ_ID. Field SQIj_STATEMENT is an SQL statement that may be 
executed to obtain the Primary ID value of the related Docking Object. 

Table S_DOBJ_TBL 69 describes the member tables of a particular 
Docking Object, described by table S_DOBJ 61. Table S_DOBJ_TBL 69 

15 includes the fields DOBJ_ID, TBL_ID, and VIS_EVENT_FIiG . Field DOBJ_ID 
identifies the Docking Object that contains the member table described 
by the row. Field TBL_ID identifies the particular teible in the 
database that is the member table described by the row. Field 
VIS_EVENT_FIia is a flag that indicates whether a change to this Docking 

20 Object Ccui result in a visibility event. A value of "Y" indicates that 
a change can result in a visibility event; a value of "N" indicates 
that it cannot. 

Table S_DOBJ_VIS_RDLE 71 contains the visibility rules associated 
25 with a particular Docking Object. S_DOBJ_VIS_RUIjE 71 contains the 
fields DOBJ_ID, RDLE_SEQDENCE , RaLE_TYPE, SQL_STATEMENT and 
CHECK_D0B J_ID . Field D0BJ_ID identifies the Docking Object with which 
a particular visibility rule is associated. Field RULE_SEQOENCE is a 
sequence number that indicates the sequence, relative to other 
30 visibility rules in table S_DOBJ_VIS_Rni,E 71, in which the particular 
visibility rule should be run. ROLE_TyPE specifies whether the 
particular visibility rule is of type "R, " indicating an SQL visibility 
rule or of type "O, " indicating a Docking Object visibility rule. 

35 If RULE_TYPE is equal to "R, " field CHECK_DOBJ_ID is not 

meaningful, and field SQL_STATE1IENT contains an SQL statement that is 
evaluated using the Primary ROW- ID of the primary table associated with 
this Docking Object and a particular Node 21. If the SQL statement 
returns any records, the Docking Object is deemed to be visible to the 

40 Node 21 for which visibility is being determined. 

If RDLE_TyPE is equal to "O, " both field CHECK_DOBJ_ID and field 
SQL_STATEMENT are meaningful. Field CHECK_D0BJ_ID specifies a docking 
object whose visibility should be determined. If the specified docking 
45 object is deemed to be visible, then the docking object associated with 

-9- 
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the visibility rule is also visible. Field SQL_STATEMENT contains a 
SQL statement that, when executed, returns the Row- ID of the docking 
object identified by CHECK_DOBJ_ID that corresponds to the docking 
object instance associated with the visibility irule. 

Table S_APP_TBL 73 is em implication Table that describes all the 
tables used in a particular application. It is pointed to by tahle 
S_DOBJ_TBL G9 for each member table in a docking object, and by table 
S_DOBJ for the primary table in a docking object. S_APP_TBL 73 points 
to table S_APP_COL 75, which is an implication Coliamn Table that 
describes the coliamis of data in a particular application. S_APP_TBL 73 
points to teUale S_APP_COL 75 directly through a primary key and 
indirectly through such means as a Foreign Key Column Table 81, User 
Key Column Table 83, and Column Group Table 85. The relationship of an 
Jf^plication Table, implication Column Table, Foreign Key Column Table, 
User Key Coltmin Table euid Column Group Table are well kno\m in the art 
and are not further described. 

Update Procesainq 

Figure 3 depicts steps performed by an update manager 31 such as 
update manager 31-a, 3X-b or 31-c in updating a database, such as a 
node database 23-a, 23-b or 23-c, responsive to user input. Execution 
of update manager 31 begins in step 101. In step 103, the update 
manager 31 accepts from the user input 33 in the form of a commauid 
requesting that the data in database 23 be altered. The request may be 
in the form of a recjuest to delete a row of a table, to add a row to a 
table, or to change the value of a cell at a particular column of a 
particular row in a table. In step 105, using a well-known means, the 
update manager 31 applies the requested update to database 23 . In step 
107, the update manager 31 creates a log record describing the update 
and writes it to update log 35 . 

The contents of a log record describe the update made. Each log 
record indicates the node identifier of the node making the update, an 
identification of the table being updated, cuid an identification of the 
type of update being made, i.e., an insertion of a new row, a deletion 
of eui existing row, or an update to an existing row. For an insertion, 
the log record additionally includes an identifier of the row being 
inserted, including its primary key and the values of the other coliimns 
in the row. For a deletion, the log record identifies the primary key 
of the row being deleted. For an update, the log record identifies the 
primary key of the row being updated, the column within the row being 
updated, the old value of the cell at the addressed row and column, and 
the new value of the cell . 
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After writing a log record in step 107, the update processor 
exits for this v^date. The foregoing description of the t^date 
processing preferably includes additional steps not material to the 
present invention, for example, to assiire authorization of the user to 
make the update, to stage and commit the write to the database to allow 
for rollback in the event of software or hardware failure, and the 
like. These steps axe well-known in the art and are not described 
further . 

An update mauiager 11 executing in central con?>uter system 1 
operates in an analogous manner, except that it updates central 
database 3 cuid writes its log records to central update log 11. 

Docking Procesaino 

Figure 4 depicts steps performed by a Docking Manager 25 such as 
Docking Manager 25 -a, 25 -b or 25 -c to transmit and/ or receive one or 
more tremsaction logs. Docking Manager 25 is invoked by the user of a 
remote node such as node 21-a, 21-b or 21-c, whereby the user requests 
that the node dock with central conputer 1 to upload an update log such 
as update log 35 -a to central computer l, to download a partial log 
such as partial log 17 -a, or both. Execution of Docking Manager 25 
begins in step 121. In step 123, Docking Manager 25 connects with 
central conjjuter 1 under the control of Central Docking Manager 5. 
This connection can be any connection that enables data exchange. It 
is anticipated that the most common form of a connection is a telephone 
line used in conjunction with a modem, but other forms of data 
connection, such as a Local Area Network or a TCP/IP connection may 
also be used. Step 125 checks to see whether the user has requested 
that node update log 35 -a be uploaded to the Central Computer 1. If 
so, execution proceeds to step 127. If not, step 127 is skipped and 
control is given to step 129. In step 127, Docking Manager 25 uploads 
its update log to central con^auter 1. The upload may be accon?)lished 
with any known file transfer means, such as XMODEM, ZMDDEM, KERMIT, 
FTP, ASCII transfer, or any other method of transmitting data. In step 
129, Docking Manager 25 checks to see whether the user has requested 
that a partial log such as partial log 17 -a be downloaded from Central 
Computer 1. If so, execution proceeds to step 131. If not, step 131 is 
skipped and control is given to step 133. In step 131, Docking Manager 
25 downloads its partial log from central conputer l . The download may 
be acconplished with any known file transfer means, such as XMODEM, 
ZMODEM, KERMIT, FTP, ASCII transfer, or any other method of 
transmitting data. In step 133, having conqpleted the requested data 
tremsfer. Docking Manager 25 exits. 
Marq^ Processlnq 
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Merge processing is performed by a processor such as node merge 
processor 27-a, 27-b, or 27-c, or central merge processor 7. The merge 
process serves to update its associated database with a trsuisaction 
that has been entered by a user of a coirputer remote from the con5>uter 
5 where merge processing is being performed. Merge processing is 
analogous to update processing and is similar in form to update 
processing as previously disclosed with reference to figure 3, with 
three differences. First, the input to a merge processor is not an 
update entered directly by a user, but rather is a log file that is 

10 obtained from a computer remote from the computer where the merge is 
executing. A second difference is that, as shown by in Figure 1, merge 
processing does not produce a log when performed at a node. The 
function of a log on a node is to record a transaction for propagation 
to Central Computer system 1 and thence to other nodes as required. A 

15 transaction that is the subject of a merge in a node has been 
commtmicated to Central Computer System 1, and there is no need to re- 
commxanicate it. 

A third difference is that merge processing must be capable of 
detecting and resolving multiple conflicting transactions. For 
20 exan^le, assume that a field contains the value "Keith Palmer." Assume 
further that a user at node 27-a enters a transaction to update that 
field to "Carl Lake," and a user at node 27-b enters a transaction to 
update the same field to "Greg Emerson." without collision detection, 
data among various nodes may become corrupt. When the transaction for 

25 user 27-a is merged, the field is updated from "Keith Palmer" to "Carl 
Lake." Without collision heuidling, when the transaction for node 27-b 
is merged, the field would be updated to "Greg Emerson, " and the 
central database would then be out of synch with the database of node 
27-a. Furthermore, when merge processing is performed on each of nodes 

30 27-a and 27-b, each node will update its database with the other's 
transactions, leaving at least one node out of synch with the other 
node and with central database. 

Therefore, merge processing must also have a means of detecting 
collisions and correcting them. In the above example, a sin5)le way to 

35 detect and correct a collision is to conpare the value in the database 
to the value that the merge log reflects as being the previous value in 
the node database. If the two values do not match. Merge processor 7 
may reject the transaction and generate a corrective transaction to be 
sent to the node from which the conflicting transaction originated. In 

40 the eOjove exan^le, when the transaction for node 27-b was presented to 
merge processor 7, merge processor 7 would compare "Keith Palmer," the 
prior value of the field as recorded by node 27-b to "Carl Lake," the 
present value of the field as recorded in central database 3 . 
Detecting the mismatch, merge processor 7 may then generate a 

45 tremsaction to cheuige the value "Greg Emerson" to "Carl Lake," and 
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write that transaction to update log 15. In a subsequent docking 
operation, that transaction would be routed back to node 27 -b to bring 
its databeise 23 -b in synch with the other dateibases. 

The above is one exanple of a collision and a resulting 
5 corrective action. Other types of collisions include, for example, an 
update to a row that has previously been deleted, inserting a row that 
has previously been inserted, and the like. Merge processing must 
detect and correct each of these collisions. This may be performed 
using any of a number of well-known methods, and is not discussed 
10 further. 

Figure 5 depicts the steps performed by merge processor such as 
central merge processor 7. Although it depicts merge processor 7 
writing to central database 3 and to transaction log 15, it is equally 
representative of a node merge processor such as node merge processor 

15 27-a, 27-b or 27-c updating a node dateibase 23-a, 23-b or 23-c. Merge 
processing begins at step 141. In step 143, merge processor 7 finds 
the first unprocessed trauisaction on received log 19. In step 147, 
merge processor 7 selects a transaction from received log 19 . In step 
149, merge processor 149 atterrpts to update database 3 according to the 

20 transaction selected in step 147. In step 151, merge processor 7 
determines whether the database update of step 149 failed due to a 
collision. If so, merge processor proceeds to step 153, which 
generates a corrective transaction. Following the generation of the 
corrective transaction, the merge processor returns to step 149 and 

25 again attenpts to update database 3 . If no collision was detected in 
step 151, execution proceeds to step 157. In step 157, merge 
processing checks to see if it is executing on central computer 1. If 
so, step 155 is executed to journal the transaction to log 15. In euiy 
case, either if step 157 determines that the merge processing is being 

30 performed on a node or after step 155, execution proceeds to step 159. 
Step 159 checks to see if any transactions remain to be processed from 
log 19. If so, execution repeats from step 147, where the next 
transaction is selected. If not, merge processing exits in step 161. 
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Log Management 

Figure 6 depicts the steps to be performed by log manager 9 to 
prepare a partial treuisaction log such as partial tremsaction log 17 -a, 
17 -b, or 17-c. The procedxire depicted in Figure 6 is executed for each 
node availaJole to dock with central computer system 1. Log manager 9 
begins execution in step 171. In step 173, Log Manager 9 finds the 
first unprocessed treuisaction for the node whose partial transaction 
log is being prepared. In step 175, log manager 9 selects a 
transaction for processing. In step 177, log manager 9 checks to see 
whether the selected trsuisaction originated on the same node for which 
processing is being performed. If so, there is no need to route the 
transaction back to the node, and control proceeds to step 179. Step 
179 checks to see whether there are any transactions remaining to be 
processed. If so, control is given again to step 175. If not, control 
passes to step 189, which records the last transaction that was 
processed for this node, and then exits at step 191. If the 
transaction originates in other than the same node as the node for 
which processing is being performed, control is given to step 181. 
Step 181 calls a visibility calculator to determine whether the 
selected transaction is visible to the node being processed. The 
Visibility calculator routine is described in detail further herein. 
In step 183, merge processor 9 checks to see whether the visibility 
calculator determined that the transaction is visible. If it is not 
visible, control is passed to step 179, which performs as disclosed 
above. If the transaction is visible, control is passed to step 185. 
Step 185 writes a record for this transaction to the partial 
transaction log for the node being processed, for example, partial 
transaction log 17 -a for node 21 -a. In step 187, the log manager 9 
records the last transaction that was processed for this node, and then 
passes control to step 179, which determines whether to select 
additional transactions or exit, as disclosed above. 
Visibility Calculatioi^ 

Figure 7 depicts a flowchart describing the process a visibility 
calculator for calculating visibility for a docking object as invoked 
by step 181 of log meuiager 9 . The visibility calculator is called with 
the node-id of the node for which visibility is being calculated, the 
docking object for which the visibility is being calculated, and the 
row-id of the docking object whose visibility id being calculated. The 
visibility calculator uses this information, in conjunction with 
information obtained from meta-data stored in the schema depicted in 
Figure 2, to determine whether a particular treuisaction that updates a 
particular row of a particular docking object is visible to a 
particular node. 

The Visibility calculator begins execution at step 201. In step 
203, the visibility calculator makes a default finding that the 
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transaction is not visible. Therefore, unless the visibility 
calculator determines that a transaction is visible, it will exit with 
a finding of no visibility. In step 205, the visibility calculator 
selects the first visibility rule associated with the docking object. 
5 This is done by finding the table S_DOBJ_VIS_RUI.E 71 associated with 
the current Docking Object as pointed to by table S_DOBJ 61. In step 
205, the visibility calculator selects the row of table S_DOBJ_VIS_RUIiE 
71 with the lowest value for field RUIiE_SEQDENCE . 

In step 207, the Visibility Calculator checks the field RnLE_TyPE 
10 for a value of "R." The value of "R" indicates that the rule is a SQL 
visibility rule. If so, the Visibility Calculator proceeds to step 
209 . In step 209 the Visibility Calculator obtains a SQL statement 
from field SQL_STATEMENT and executes it. An exanqple of such an SQL 
statement might be: 
15 SELECT 'X' FROM S_OPTy_EMP 

WHERE OPTY_ID = : PrimaryRowId 
AND EMP_ID = :NodeId; 

This SQL statement causes a query to be made of application table 
20 S_OPTY_EMP. The query selects any records meeting two criteria. 
First, the records selected must have a field OPTY_ID, which is a row 
id or key, equal to the Primary Row- ID of the Docking Object whose 
visibility is being determined. Second, the records selected must have 
a field EMP_ID, which may be for exanple, eui identifier of a particular 
25 enployee, equal to the Nodeld of the node for whom visibility is being 
determined. In ordinary language, this SQL statement will return 
records only if a row is found in a table that matches en^loyees to 
opportunities, where the opportunity is equal to the one being updated, 
and the employee to whom the opportunity is assigned is the operator of 
3 0 the node. 

This is a 8in5>liBtic exanple, provided for maximum comprehension. 
More con5)lex SQL statements are possible. For example, the rule: 
SELECT 'X' FROM 
&Table_Owner . S_ACCT_POSTN ap 
35 &Table_Owner . S_EMP_POSTN ep 

WHERE ap.POSITION_ID = ep. POSITION ID 
AND ep.EMP_ID = : Node Id; ~ 

This rule queries the tables S_ACCT_POSTN (which relates a 
40 particular account with a particular position in the organization that 
is responsible for the account) and S_EMP_POSTN (which relates what 
en^jloyee corresponds to a particular position) . The condition 
"ap.POSITION_ID = ep .POSITION_ID'' requires finding a row in the 
account-to-position table that has the same position as a row in the 
45 enr^jloyee- to -position tcible. The condition °ep.EMP_ID = : Nodeld" 
further requires that the selected row in the en?)loyee-to-position 
table also have an Enployee ID equal to the ID of the user of the Node 
for which visibility is being determined. In ordinary language, this 
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condition allows visibility if the enployee occupies the position that 
has responsibility for the accoimt in the docking object being updated. 

There is no particular limit to the con^jlexity of the conditions 
in the SQL statement used to evaluate visibility. Particular 
5 implementations of SQL may in^ose limitations, cuid resource 
considerations may make it desirable to use less coii^>lex statements, 
but these limitations are not inherent in the invention. 

Step 211 evaluates whether the execution of SQL_STATEMENT in step 
209 returned any records. If records were returned, this indicates 
10 that the Node for which visibility is being checked has visibility to 
the docking object being processed. Accordingly, if records are 
returned, the Visibility Calculator proceeds to step 213. In step 213, 
the transaction is marked visible. Because no further rules need to be 
evaluated to determine visibility, the visibility calculator proceeds 
15 to step 228. Step 228 synchronizes the databases by determining 
whether the calculated visibility requires the insertion or deletion of 
a docking object into a particular node's partially replicated 
database. This may occur, for example, if a node is determined to have 
visibility to a docking object due to a change to a related docking 
20 object. For example, an owner of a node may be assigned to a 
particular activity that is related to a particular sales opportunity. 
As a result, the node should be provided with a copy of the object 
representing the sales opportunity. 

Figure 8 depicts the steps performed to synchronize a partially 
25 replicated database in response to a change in data visibility. 
Execution begins in step 241. In step 243, the Visibility Calculator 
references the visibility just calculated for a docking object. If the 
Docking Object is visible, execution proceeds to step 245. Step 245 
references the S_D0BJ_INST table, to verify that a row exists for the 
30 Docking Object for the current node. If a row exists, this indicates 
that the node in question already has a copy of the referenced Docking 
Object, emd the routine proceeds to step 255, where it exits. If, 
however, no row exists for the Docking Object at the node being 
processes, this indicates that the node in question does not have a 
35 copy of the Docking Object on its partially replicated dataOaase. The 
routine then proceeds to step 247, where a treuisaction is generated to 
direct the node to insert the Docking Object into its partially 
replicated datsQsase. 

If step 243 determines that the Docking Object is not visible, 
40 execution proceeds to step 249. Step 249 references the S_DOBJ_INST 
t£d)le, to verify that no row exists for the Docking Object for the 
current node. If step 243 determines that no row exists in the 
S_DOBJ_INST table for the current docking object for the current row, 
this indicates that the node in question does not have a copy of the 
45 referenced Docking Object, and the routine proceeds to step 255, where 
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it exits. If, however, a row exists for the Docking Object at the node 
being processed, this indicates that the node in question does have a 
copy of the Docking Object on its partially replicated database. The 
routine then proceeds to step 251, where a transaction is generated to 
direct the node to delete the Docking Object from its partially 
replicated database. 

Referring again to Figure 7, following the data synchronization 
routine of step 228, the Visibility Calculator proceeds to step 229, 
where it exits. Referring to Figure 6, as previously described, the 
resulting finding of visibility is available to be checked by the log 
manager in step 183 to determine to write the transaction. 

Referring agadn to figure 7, if step 211 determines that no 
records were returned by the execution of the SQL statement in step 
209, execution proceeds with step 215. Step 215 checks to see whether 
there are any remaining visibility rules to be assessed. If not, the 
visibility calculator proceeds to step 228 to synchronize the database, 
and then to step 229, where it exits. In this case, the default mark 
of no visibility that was set in step 203 remains set. This value will 
also be used by the log manager as shown in Figure 6, step 183, to 
determine not to write the transaction. 

Referring again to Figure 7, if rules remain to be assessed, 
control proceeds to step 217, which selects the next rule to be 
processed. Control is then given again to step 207 to begin processing 
the new rule. 

The preceding text provided a description of the processing or 
SQL visibility rule; that is, visibility rules of type "R. " If step 
207 determines that the visibility rule is not of type "R, " the 
visibility rule is of type "O." Type "O" indicates a docking -object 
visibility rule. In such a case, the docking object being processed 
will be considered to be visible if it is related to a particular 
related docking object that is visible. If field RDLE_TYPE is not 
equal to "R, " then, execution proceeds to step 221. Step 221 
determines the related Docking Object whose visibility must be 
determined to determine whether the current docking object is visible. 
The related Docking Object identifier is obtained from field 
CHECK_DOBJ_ID in table S_DOBJ_VIS_RDLE 71. In step 223, the Visibility 
Calculator determines which row in the related Docking Object must be 
queried for visibility. In order to determine this, the Visibility 
Calculator obtains a predetermined SQL statement from the field 
SQL_STATEMEl!JT and executes it. The SQL statement is a query that 
select one or more rows of the Docking Object that, for exan^le, 
correspond to the docking object for which the Visibility Calculator 
was invoked . 
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For exani>le, assume that it is desired to indicate that a record 
for a sales opportunity should be visible if the Node has visibility to 
any sales quote made for that sales opportunity. This may be 
accomplished using the following SQL statement: 
SBLECT"_1D" FROM 

&Table_Owner . S_DOC_QUOTE 
WHERE OPTY_ID= : Primeury Rowld 

This SQL statement accesses a table S_DOC_QUOTE that contains all 
sales quotes. The VJHERE clause specifies retrieval of all rows where 
the Opportunity ID of the row is equal to the Row -ID of the opportunity 
for which visibility is being calculated. The Visibility manager 
retrieves the specified Row- Ids, thereby identifying the rows of the 
S_DOC_QU0TE table whose visibility must checked. 

Having determined the a related docking object and the row- ID of 
that related docking object upon whose visibility the visibility of the 
current docking object depends, the Visibility Calculator proceeds to 
step 225. In step 225, the Visibility Calculator recursively invokes 
itself to determine visibility of the related docking object. The 
recursively invoked Visibility Calculator operates in the same manner 
as the Visibility Calculator as called from the Log Manager 9, 
including the capeUaility to further recursively invoke itself. When 
the recursive call concludes, it returns a visibility indicator for the 
related Docking Object, and control proceeds to step 227. In step 227, 
the Visibility calculator determines whether the related Docking Object 
was determined to have been visible. If so, the Visibility Calculator 
proceeds to step 213 to mark the originally current Docking Object as 
visible, euid then to step 228 to synchronize the database and then to 
step 229 to exit. If the related Docking Object was not determined to 
be visible, control proceeds to step 215 to determine whether 
additional visibility rules remain to be assessed. 

The Visibility Calculator, in conjunction with the Log Manager is 
therefore able to determine what subset of update transaction data is 
required to be routed to any particular node. This operation serves to 
reduce the trcmsmission of unneeded data from the Central Computer 1 to 
the various nodes such as nodes 21-a, 21-b and 21-c that utilize 
partially replicated databases, and to reduce the system resources such 
as disk space needed to store, and the CPU time needed to process, what 
would otherwise be required to maintain a fully replicated database on 
each remote node. 

The operation of the log manager 9 in conjunction with the 
Visibility Calculator herein described will be apparent from reference 
to the description and to the drawings. However, as a further aid in 
the description of these facilities, a pseudocode representation of 
these facilities is hereto attached as an Appendix. 
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Software Distribution Integrati on with Remote Uporada 

The docking facility of the present invention also permits the 
distribution of software v^grades emd related database schema. This 
provides an easy process to allow administrators to notify remote users 
5 of the existence of software upgrades and to distribute software 
upgrades to remote users . It provides an easy process for remote users 
to receive notification of software upgrades and to apply the software 
upgrade. It provides a means to associate a software upgrade with a 
remote schema upgrade so that the software upgrade is not e^plied 

10 before the remote schema upgrade. It provides a means for a remote 
user to provide feedback regarding a successful or unsuccessful 
con5>letion of the software upgrade to the administrator. 

Typically, iii:5)lementation of software upgrades is very passive. 
The user does not actively receive information about the availcibility 

15 of software that should be downloaded. Users are required to download 
the file manually, and, once received, the upgrade is installed using 
an installer package separate from the software package being upgraded. 
It would be advantageous to provide a means in the software package to 
publish the availability of software for download to remote users so 

20 that the remote users are informed of the need to download software and 
are prompted when the download should occur, and provide for the 
dependency of a software upgrade on an accompanying schema upgrade . 

According to one embodiment of our invention there is provided 
25 is a method of upgrading a software application from one or more 
upgrade package files in a server (1) to a client (21a, 21b, 21c) . 
According to this method a copy of the upgrade package files and an 
upgrade dateUaase table are created on the server (1) . A pointer is 
created in the client's (21a, 21b, 21c) file on the server (1). This 
30 pointer points to the upgrade package files on the server (1) ; In 

invoking the upgrade the, the upgrade files are made active, and the 
upgrade database table is scanned when a client (21a, 21b, 21c) 
docks. This is to determine the status of an upgrade with respect to 
the particular client (21a, 21b, 21c) . The upgrade is copied to the 
35 client (21a, 21b, 21c) if the client (2la, 21b, 21c) has not received 
the upgrade. At this point the upgrade may be invoked at the client 
(21a, 21b, 21c) . 

The upgrade can be invoked at any point during a docking 
40 session, for exau^jle, at the beginning of a client (21a, 21b, 21c) 

session., or, and most preferably, at the end of a client (21a, 21b, 
21c) session. The upgrade cem be invoked at the client user's 
option, or at the server's option, that is, by forced downloading as 
will be described hereinbelow. 

45 
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One way of implementing the invention, as will be described 
more fully hereinbelow, is to create a docking item file type to scan 
the upgrade database table when the client (2la, 21b, 21c) docks to 
thereby determine the status of an upgrade with respect to the client 
5 (21a, 21b, 21c) . 

These various aspects of our invention may be implemented as 
program products. That is, they may be implemented as a computer 
usable medium with coit^juter program code embodied therein for 

10 causing the upgrading of a software application from upgrade package 
files in a server (1) to a client (21a, 21b, 21c) . The computer 
readable program in the program product article of manufacture 
contains computer readable program code means for causing a computer 
to effect creating a copy of the upgrade package files on the server 

15 (1) , creating an upgrade database table on the server (1) ,- creating 
a pointer in the client's (21a, 21b, 21c) file on the server (1) 
pointing to the upgrade package files on the server (1) , making the 
upgrade active, scanning the upgrade database table when a client 
{21a, 21b, 21c) docks to determine the status of an upgrade with 

20 respect to the client (21a, 21b, 21c) , copying the upgrade to a 

client (21a, 21b, 21c) if the client (21a, 21b, 2lc) has not received 
the upgrade, and invoking the upgrade at the client (2la, 21b, 21c) . 

Additionally, our invention may be implemented as a program 
25 product in the form of a program storage device readable by a 

machine, tangibly embodying a program of instructions executable by 
a machine to perform method steps for of upgrading a software 
application from upgrade package files in a seirver (1) to a client 
(21a, 21b, 21c) said method steps comprising creating a copy of the 
30 upgrade package files on the server (1) , creating an upgrade database 
table on the server (l) ; creating a pointer in the client's (21a, 
21b, 21c) file on the server (1) pointing to the upgrade package 
files on the server (l) , making the upgrade active, sceuining the 
upgrade database teible when a client (21a, 21b, 21c) docks to 
35 determine the status of an upgrade with respect to the client (21a, 
21b, 21c) , copying the upgrade to a client (21a, 21b, 21c) if the 
client (21a, 21b, 21c) has not received the upgrade, and invoking the 
upgrade at the client (21a, 21b, 21c) . 

40 The integrated update works as follows. At the end of a normal 

docking session, the user is prompted with the information regarding 
the availedsility of a software upgrade. The user has the option to 
download the software upgrade or to defer and download the software 
upgrade later. This can be overridden by the system administrator, who 

45 has the ability to mark the file as a force download. In such a case. 
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the user is not pron^jted to download the file; instead, the file is 
downloaded without input from the user. The user is pronpted using a 
message box that has the ability to time out. 

There are two classes of software upgrades: software that is 
5 being distributed in conjunction with a schema upgrade euid softweure 
that is not associated with a schema upgrade. If the software is 
associated with a schema upgrade, the software upgrade is not applied 
until after the schema upgrade has been applied. The applying of the 
schema upgrade invokes the software upgrade at the end of the 

10 processing of the schema upgrade. If the software is not associated 
with a schema upgrade, then after successfully downloading the software 
upgrade files, the user will be pron?)ted to apply the upgrade now or to 
defer. The administrator will have the ability to force the applying 
of the software upgrade immediately upon coir5)letion of the docking 

15 session. 

Once the user chooses to apply the software upgrade, the 
installation conponent is invoked and the database application is 
closed. The installation component then guides the user through the 
necessary steps needed to apply the software. 

20 The system administrator uses a dialog to specify the association 

of files, messages and schema upgrades for eui upgrade package. The 
dialog includes a master section and a detail section. The master 
section allows for the creation of a header record that names the 
upgrade package euid specifies some general attributes regarding the 

25 upgrade. The detail section associates software upgrade files, 
messages and schema upgrades. 

The attributes of the master record include the name of the 
upgrade package; the schema version of the database after the upgrade 
is applied; a message supplied to users to view prior to downloading 

30 the upgrade; a message to be displayed when the upgrade is applied; a 
download attribute indicating how the file must be downloaded, e.g., 
whether the file must be downloaded immediately or whether it may be 
deferred by the user; an application attribute indicating how the 
upgrade may be applied, e.g., whether the upgrade must be applied 

35 immediately, may be deferred by the user, or must be deferred pending 
a corresponding upgrade of a corresponding schema or software upgrade; 
£uid a description. 

The attributes of the detail record include a record type 
40 indicating whether the file is a message, a software upgrade, etc., and 
the name of the file. 

Upgrades are denoted by a record in an upgrade t£Q>le in the 
dataibase. Once a record is created in the upgrade table and the 
associated upgrade package is made active. Log Mcuiager routes this 
45 information using the previously described docking mechanisms to remote 
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users by creating an entry in the users' server. ts files. This entry 
points to a global upgrade table of contents (TOO file. A single TOC 
file serves all docking users per application server installation. The 
upgrade TOC file contains the detailed infombtion regarding the 
5 upgrade paclcage. In this embodiment, only one upgrade package is 
active at a given time. 

When a user docks and retrieves the server. ts file, the docking 
client scans the server. ts file for the existence of upgrade entries. 
Depending upon the attributes of any upgrade entries in the server. ts 
10 file, either the upgrade files be downloaded immediately or a message 
is displayed to the user. The user optionally has have the option 
either download the files during the current docking session or defer 
download until a later docking session. 

Depending upon the attributes of the upgrade package, the 
15 installation coiqponent may be invoked automatically or the user may 
defer applying the upgrade . If the software upgrade is associated with 
a schema upgrade, then after the schema upgrade has been applied, the 
status of software upgrade files is checked to verify that all files 
associated with the upgrade have been downloaded. Any files not yet 
20 downloaded will be downloaded, making a connection to the application 
server if necessary. The software upgrade will then be invoked by the 
installation component. 

The file types are represented by the field UTLTocFileType . A 
file type of DTLTocFileTOCUpg indicates the Upgrade TOC file, and a 
25 file type of DTLTocFileUpgrade indicates a file that is a constituent 
part of an upgrade. Optionally, a file type of DTLTocFileMessage 
indicates a file containing a message to be displayed to the user. 

The upgrade is represented to the user as a new dock item type, 
named CSSDockUpg. The CSSDockUpg class is derived from the CSSDockltem 
30 class. 

When the user docks and is sending or receiving data from the 
server, the CSSDockUpg dock item type is created. When executed, this 
class examines the server, ts file for an entry type of 
DTLTocFileTOCUpg. If found, either the message specified by the entry 

35 pre-download message will be displayed to the user using a time-out 
dialog box at the end of the docking session or the files will be 
downloaded immediately depending on the attributes of the entry type 
UTLTocFileTOCUpg . 

Once the files are downloaded, the apply message from the upgrade 

40 TOC file is displayed to the user at the end of the docking session. 
Alternatively, the installation conponent is invoked by the mobile 
client. 

When the upgrade is applied, the installation conqponent is 
invoked. If the user defers application of the upgrade, then each time 
45 the user issues docks to the headctuarters server, the docking client 
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looks for the upgrade TOC file in the upgrade directory on the client 
machine. If the file exists, the apply message is displayed to the 
user. 

After the upgrade files have been downloaded the u^jgrade TOC file 
5 is stored locally on the client. This file will then be examined after 
the schema upgrade process has coaxpleted. 

The master copy of the upgrade package files is placed on the 
file server. VJhen a Log Uanager process is processing a user euid 
encounters the transaction that makes the upgrade package active. Log 
10 Manager copies these files to the local application server upgrade 
directory if the files do not already exist. Log Manager also creates 
the upgrade TOC file in this directory if the TOC file does not already 
exist. 

Once an upgrade package is marked as active, a record in the 
15 docking transaction log is created. This record will cause the log 
preprocessor to create the global upgrade TOC file. The contents of 
the file are inserted into a text column of the upgrade package. When 
the log router is executing for a particular user, this record will 
cause the log router to create an entry in the user's server. ts file, 
20 which that points to the global upgrade TOC file. The log router also 
ensures that the global upgrade TOC file exists in a predetermined 
directory. If the file exists, the log router reads the text column of 
the upgrade package that contains the contents of the TOC file and 
creates the global upgrade TOC file . Alternatively, the log router may 
25 read the text colvrnm and create an upgrade TOC file for each user. 
This would prevent more than one log router executable from creating 
the global upgrade TOC file. 

In some cases, a schema upgrade will require a corresponding 
30 software upgrade in order for the schema to function properly. This 
may occur, for example, when the vendor supplies a new software -schema 
pair. A customer cannot cause a software version conflict with the 
ability for dbinit/data merge to apply the schema changes. If schema 
upgrade that requires a corresponding software upgrade is to be 
35 applied, the software upgrade must be applied first, because it is the 
new software that provides support for the schema upgrade. 

An example of this scenario is when the vendor ships new software 
and a new version of the database. The system administrator packages 
the software and makes it available for download by the user. The 
40 system administrator then applies the database upgrade to the central 
database . 

At some point, a remote user docks and is informed that the 
central database has been updated, and that the user's docking 
operation is limited to downloading chsmges to the database; that is, 
45 the user is not permitted to upload transactions until his own 
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partially replicated datoibase has been upgraded to match the central 
database schema. The user then downleads the database upgrade files 
corresponding to the upgrade installed on the central datsdsase. The 
installation component is invoked {either by the client -side software 

5 upon detecting the upgrade condition, or expressly invoked by the user, 
depending on the upgrade file's attributes). The installation 
cozi^onent opens the database upgrade files and contains a checksum 
value for the upgrade file set. The checksum is compared against a 
value in the user's configuration file that uniquely identifies the 

10 user's software level. If the checksum value is different, then the 
client software does not have the ability to apply the schema changes. 
The schema changes will be deferred until the user separately upgrades 
his or her software level. 

A checksiun may also be included in the DX files that represent 

15 transactions. The data merge component verifies the checksum 
associated with the transaction against the checksum in the 
configuration file. If the checksums do not match, the application of 
the DX file is deferred. This prevents a user from inadvertently 
applying changes that cannot be supported by the software. 

20 CONCLUSION 

Various modifications to these embodiments will be readily 
apparent to those skilled in the art, and the generic principles 
defined herein may be applied to other embodiments without the use of 
inventive faculty. Thus, the present invention is not intended to be 

25 limited to the embodiments shown herein, but is to be accorded the 
widest scope consistent with the principles and novel features 
disclosed herein. 

All publications and patent applications mentioned in this 
specification are herein incorporated by reference to the same extent 

30 as if each individual publication or patent application was 

specifically and individually indicated to be incorporated by 
reference . 

The invention now being fully described, it will be apparent to 
one of ordinary skill in the art that many changes and modifications 
35 can be made thereto without departing therefrom. 



40 
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APPENDIX 

Writing Usar Tranaaction Log File for a Given Laptop Mode 
This program will be called by a server- side process that 
processes treuisaction log entries for all Laptop Nodes. For each 
LE^Jtop Node, the calling process building the UserTrxnLogFileName and 
calling Program 1. 

Input Parameters 

• LaptopNodeld - node_id of the destination laptop 

• UserTxnLogFileName - full path of the file where txns 
will be written 

• MaxBatchTxns - number of txns between commits and updates 
to the S_DOCK_STATDS table 

• MaxTxns - number of txns to process in this session. Use 
this parameter to limit processing. 

Main Algorithm 

- - Check parameters 

IF (MaxTxns < 1 | 1 MaxBatchTxns < 1) THEN 

Invalid Parameter 
END IF 

-- Get last LOG_EXTRACT number for the Laptop from 
S_DOCK_STATUS 
last_txn_commit_number = 
XJTLDStatGetLogNum( LaptopNodeld) ; 

-- Initialize Variables 

NumTxns = 0; -- Total niimber of txns processed 

NumBatchTxns =0; -- Total number of txns written in 
the current batch 

-- Read Docking Object and Table definitions into memory 

structures 

StartDictApi ( ) ; 

- - Open the User Log Txn file 
Open User Log Txn file 

-- Select and process new txns in S_DOCK_TRANSACTION_L0G 

- - where txn_commit_n\unber > last_txn_conunit_nvimber 
FOR each new txn LOOP 

-- Stop processing if reach MaxTxns 
IF NiamTxns = MaxTxns THEN 

break; 
END IF; 

-- Prevent circular txns. Do not send the txn back to 
the originating laptop 

IF txn.OriginNodeld = LaptopNodeld THEN 

Goto next transaction 
END IF; 

-- Process all other types of transactions 
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-- This is the visibility calculator! 
-- This routine also processes implicit visibility 
events 

-- Later: Data Merge can call this function to check 
whether a txn is 

still visible when merging txns into a laptop or 
server database. 

CheckVisibility (LaptopNodeld, LogRecordType , 
TableName, TransRowId) ; 

IF txn is visible THEN 

- - Write transactions to UserTxnLog file depending on 

the 

- - type of LogRecordType . 

Write the txn to the user log file 
+ +NumBat chTxns 
END IF; 

- - Finished processing the txn 

-- Commit (if needed) 

IF NumBat ChTxns = MaxBatchTxns THEN 

- - Assume that separate process comes around and 
deletes 

-- Txns in S_DOCK_TRANSACTION_LOG that have been 
processed 

-- for all nodes. So, no need to delete the txns from 
the log. 

Update last LOG_EXTRACT nxunber for Laptop in 
S_DOCK_STATUS 
Commit ; 

NumBat ChTxns = 0 
END IF; 

++NumTxns 

End Loop; /* Each transaction in the Txn Log table */ 

- - Commit 

Update last LOG_EXTRACT number for Laptop in 

S_DOCK_STATUS 

Commit ; 

Close log file (if needed) 
IF UserTxnLogFileP != NULL THEN 

Close File; 
END IF; 

StopDictApi {); 
Check Visibility Routines 

- - Check if a record in the txn log is visible to a 
LaptopNodeld 

BOOL CheckVisibility (LaptopNodeld, LogRecordType, 

Tabl eName , TransRowId ) 

{ 

-- SQLStatements routed based on the destination list 
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IF LogRecordType in ( ' SQLStatement ' ) THEN 
IF Laptop Node in destination list THEN 

return TRUE; 
END IF; 

- - Shadow and Multi Record LogRecordTypes are routed to 
all nodes 

-- No visibility events with these LogRecordTypes. 
ELSIF LogRecordType in (' ShadowOperation' , 
'MultiRecordDelete' , 

'MultiRecordUpdate' ) THEN 

return TRUE; 

-- Simple Deletes need more processing 

ELSIF LogRecordType in {'Simple Delete') THEN 

IF (table. visibility in ('Enterprise', 'Limited')) 

THEN 

return TRUE; 
END IF; 

Simple Inserts and Simple Updates need more 
processing 

-- CheckTxnVisibility 0 also processes implicit 
visibility events 

ELSIF LogRecordType in ('Simple Insert', 'Simple 
Update ' ) THEN 

IF (table. visibility = 'Enterprise') THEN 

return TRUE; 
ELSIF table. visibility = 'Limited' THEN 

IF CheckTxnVisibility (LaptopNodeld, Table, Rowld) 

THEN 

return TRUE; 
END IF; 
END IF; 
END IF; 

} 

-- Check if a record in the txn log is visible to a 
LaptopNodeld 

static BOOL CheckTxnVisibility (LaptopNodeld, Table, 

Rowld) 

{ 

BOOL bVisible = FALSE; 

Find the Table in the Dictionary; 
IF Table not found THEN 

Error: Teible not defined 
END IF; 

FOR all docking objects that the table belongs to LOOP 
-- Generate SQL to get Primaryld values of the 
Docking Object 

GeneratePrimaryldSQL (Table, Rowld, DockingObject) ; 
FOR each Primaryld value retrieved LOOP 

CheckObjectVisibility (LaptopNodeld, PrimaryTable, 
PrimaryRowId) 
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IF Object is visible THEN 
-- Because CheckObjectVisibility () also processes 
implicit 

-- visibility events, we must loop through ALL 
clocking objects 

- - even if we already know that the Txn is 

visible. 

-- Exception: if the teible has VIS_event_FLG = 'N' 

then we can return immediately. 
IF Table. visibilityEventFLG = 'N' THEN 
return TRUE; 

bVisible = TRUE; 
END IF; 
END IF; 
END LOOP; 
END LOOP; 

return bVisible; 

} 



-- Check if an instance of a docking object is visible to 
the laptop user. 

-- Also processes implicit visibility events! 
BOOL CheckObjectVisibility (LaptopNodeld, 
DockingOb j ectName , PrimaryRowId) 

FOR each visibility rule for the Docking Object LOOP 
IF RuleType = RuleSQL THEN 

Run the select SQL statement using PrimaryRowId; 
IF any rows returned THEN 
-- row is visible 

-- Process an implicit Download Object 
DownloadObjectlnstance (LaptopNodeld, 
PrimaryTableName , 

PrimaryRowId) ; 

return TRUE; 
END IF; 

ELSIF RuleType = CheckDockingObject THEN 

Run the ParameterSQL using PrimaryRowId to get 
newPrimaryRowId 

FOR each record retrieved by ParameterSQL LOOP 
-- RECURS IVEl 

CheckObjectVisibility {LaptopNodeld, 
CheckDockingOb j ectName , 

newPrimaryRowId) ; 

IF rc = TRUE THEN 
-- Process an implicit Download Object 
DownloadObj ectlnstance (LaptopNodeld, 
PrimaryTableName , 

PrimaryRowId) ; 

return TRUE; 
END IF; 
END LOOP; 
END IF; 
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END LOOP; 

-- Object is not visible. 

5 -- Process an implicit Remove Object 

RemoveObjectlnstance (LaptopNodeld, PrimaryTableName, 
PrimaryRowId) ; 

return FALSE; 

10 } 

Generate SQL Statement to Get Primaryld 

-- Generate the SELECT SQL statement to get the Primaryld 
15 value of 

-- the docking object for the given MemberTable 

-- SQL statement looks like: 
SELECT tp.<row_id> 
20 -- FROM <table_ovmer>.<Table> tl, 

<table_owner>.<PKTable> t2, 
... one or more intermediate tables 
between the table 

and the PrimaryTable 
25 -- <table_owner>, <PKTable> tN 

<table_ovnier>.<PrimaryTable> tp 
WHERE tl.ROW_ID = : row_id /* row id in transaction 

log */ 

/* join to PK table t2 */ 
30 -- AMD tl.<FKColumn> = t2 . <PKColuinn> 

AND <tl FKCondition> 

/* any number of joins until reach the table 

that joins 

to the PrimaryTable */ 
35 -- /* join from t2 to tN */ 

AND t2 .<FKColvimn> = tN.<PKColumn> 
AND <t2 FKCondition> 
/* join to the PrimaryTable */ 
AND tN.<FKColumn> = tp . <PKCol\imn> 
40 - - AND <tN FKCondition> 

- - Note that there may be one or more paths from the 
Member Table 

--to the Primary Table. We need to generate a SQL select 
45 statement 

-- for each of the paths and UNION the statements 
together. 

-- This function assumes that there are no loops in the 
50 definition. 

-- These SQL statement do not change for each Table in a 
Docking Object, 

-- so we can calculate them one and store them in memory. 

55 
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Struct 
{ 

CHAR* selectList; 
CHAR* fromClause; 
CHAR* whereClause; 

UINT niunTables; /* also the nxomber of joint to reach 
the Primary Table */ 
} GenStmt; 



GeneratePrimaryldSQL (Table, DockingObject) 

/* there may be more than one SQL statement, so we have 
a dynamic 

array of SQL statements. Each element in the array 
is a path 

from the Table to the Primary Table*/ 
DynArrld GenStmtArr; 
GenStmt newGenStmt; 

CHAR* sqlStmt; 

DynArrCreate (GenStmtArr) ; 

-- Create the first element and initialize 

newGenStmt = mallocO; 

newGenStmt.numTables = l; 

newGenStmt .selectList = "SELECT row_id"; 

newGenStmt . fromClause = "FROM <Table> tl"; 

newGenStmt .WhereClause = "WHERE tl.ROW_ID = :row_id"; 

DynArrAppend (GenStmtArr, &newGenStmt) ; 

/* Recursively follow FKs to the PrimaryTable */ 
Build the select, from and where clause 
simultaneously */ 

AddPKTable (Table, DockingObject , GenStmtArr, 0) ; 

- - Union all the paths together 
numStmts = DynArrSize (GenStmtArr) ; 
FOR all elements in the array LOOP 

tmpSqlStmt = GenStmtArr [j] .selectList ] | 
GenStmtArr [j] .fromClause | ] GenStmtArr [j ] .whereClause; 

sqlStmt = sqlStmt | 1 'UNION' | | tmpSqlStmt; 
END LOOP; 

DynArrDestroy (GenStmtArr) ; 

IF sqlStmt = NULL THEN 

Error: no path from Table to Primary Table. 
END IF; 

} 



-- Recursively follow all FKs to the Primary Table 
AddPKTable (Table, DockingObject, GenStmt, InputStmtNum) 
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UINT numFKS = 0; 
UINT StmtNvun; 
GenStmt newGenStmt; 

5 FOR all FKs for the table LOOP 

IF PKTable is a Member Table of the Docking Object 

THEN 

-- If there's more thcin one FK, then there is more 
than one path 
10 -- out of the current table. 

-- Copy the SQL stmt to a new DynArrElmt to create a 
new path 

IF numFKs > 0 THEN 
- - Create a new element and copy from 
1 5 GenS tmt [ Inputs tmtNum] 

newGenStmt = mallocO; 
newGenStmt .numTables = 
GenStmt [InputStmtNum] .numTables; 
newGenStmt . selectList = 
20 GenStmt [InputStmtNum] .selectList; 

newGenStmt . fromClause = 
GenStmt [InputStmtNum] . fromClause; 

newGenStmt .whereClause = 
GenStmt [ Input StmtNvim] .whereClause; 
25 DynArrAppend ( GenS tmt Arr, saiewGenStmt) ; 

S tmtNum = DynArrSize (GenS tmt Arr) ; 

-- Put a check here for infinite loops 
IF S tmtNum ==20 THEN 
30 Error: Probably got an Infinite loop? 

END IF; 
ELSE 

S tmtNum = InputStmtNum; 
END IF; 

35 

- - Append the new PKTable to the fromClause and 
WhereClause 

GenStmt [StmtNum] .fromClause = 

GenStmt [S tmtNum] .fromClause || "An <Table> 
40 t<numTables + 1>"; 

GenStmt [StmtNum] .whereClause = 

GenStmt [StmtNum] .whereclause | | 
"AND t<nvimTables>.<FKColumn> = t<numTables + 
l>.<PKColumn>" | | 
45 "AND <FKCondition for Table if any>"; 

++GenStmt . nximTables ; 

-- PKTable is the Primary Table then Done. 
IF PKTable = PrimaryTable THEN 
50 RETURN; 

ELSE 

AddPKTable (PKTable, DockingOb j ect , GenStmt, 
StmtNum) ; 

END IF; 
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-- Only cotint FKs to other member tables in the same 
Docking Object 
++ntimFKs ; 

5 END IF; 

END LOOP; 
RETURN; 

} 

10 Process Visibility Events 

-- Download an Object Instance to a Laptop 
- - This function also downloads all Related Docking 
Object instances. 
X5 BOOL DownloadObject Instance (LaptopNodeld, ObjectName, 
PrimaryRowId) 
{ 

-- Check if the object instance is already downloaded 
to the laptop 

20 Find the object instance in the S_DOBJ_INST table 
IF exists on laptop THEN 

return TRUE; 
END IF; 

25 -- Register object instance in S_DOBJ_INST table 

-- Write Download Object records to the Txn Log 
FOR each member table of the docking object LOOP 
Generate SQL select statement to download records 
30 Write each retrieved record to the User Txn Log file 

END LOOP; 

-- Download records for Parent Object instances 
FOR each RelatedDockingObject LOOP 
35 Run ParameterSQL to get newPrimaryld of 

RelatedDockingOb j ects 

FOR each newPrimaryld retrieved LOOP 

-- Check if the instance of the object is visible 
to the laptop user 
40 CheckObjectVisibility (LaptopNodeld, ObjectName, 

PrimaryRowId) 

IF visible THEN 
DownloadObj ectlnstance (LaptopNodeld, 

RelatedDockingOb j ect , 

45 newPrimaryRowId) ; 

END IF; 
END LOOP; 
END LOOP; 

50 return TRUE; 
} 



-- Remove an Object Instance to a Laptop 
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-- This function also removes all Related Docking Object 
instances . 

BOOL RemoveObject Instance (LaptopNodeld, ObjectName, 
Pr imaryRowId ) 
5 { 

-- Check if the object instance is already downloaded 
to the laptop 

Find the object instance in the S_DOBJ_INST table 
IF does not exist on laptop THEN 
10 return TRUE; 

END IF; 

-- Delete the object instance from S_DOBJ_INST table 

15 -- Write Remove Object records to the Txn Log 

FOR each member table of the docking object LOOP 
Generate SQL select statement to get records to 
delete 

Write each retrieved record to the User Txn Log file 
20 END LOOP; 

- - Remove for Parent Obj ect instances 
FOR each RelatedDockingObject LOOP 

Run ParameterSQL to get newPrimaryld of 
25 RelatedDockingObjects 

FOR each newPrimaryld retrieved LOOP 
-- Check if the instance of the object is visible to 
the laptop user 

CheckObjectVisibility (LaptopNodeld, ObjectName, 
30 Pr imaryRowId) 

IF not visible THEN 
RemoveObj ectlnstance (LaptopNodeld, 

RelatedDockingOb j ect , 

newPr imaryRowId) ; 
35 END IF; 

END LOOP; 
END LOOP; 

return TRUE; 

40 } 



-33- 



Copied from 09967400 on 12/14/2005 



A method of upgrading a software application from 
upgrade package files in a server (l) to a client 
{21a, 21b, 21c) comprising the steps of: 

a) creating a copy of the upgrade package files 
on the server (1) ; 

b) creating an upgrade database table on the 
server (1) ; 

b) creating a pointer in the client's (21a, 21b, 
21c) file on the server (1) pointing to the 
upgrade package files on the server (l) ; 

c) making the upgrade active; 

d) scanning the upgrade database table when a 
client (21a, 21b, 21c) docks to determine the 
status of an upgrade with respect to the client 
(21a, 21b, 21c) ; 

d) copying the upgrade to a client (21a, 21b, 21c) 
if the client (21a, 21b, 21c) has not received 
the upgrade; and 

e) invoking the upgrade at the client (21a, 21b, 
21c) . 

The method of claim 1 comprising invoking the 
upgrade at the beginning of a client (21a, 21b, 21c) 
session. 

The method of claim 1 comprising invoking the 
upgrade at the end of a client (21a, 2lb, 21c) 
session. 

The method of claim 1 comprising invoking the 
upgrade at the client's (21a, 21b, 21c) option. 

The method of claim 1 comprising invoking the 
upgrade at the server's (1) option. 
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The method of claim l coit5)rising creating a docking 
item file type to scan the upgrade database table 
when the client (21a, 21b, 21c) docks to thereby 
determine the status of an upgrade with respect to 
the client (21a, 21b, 21c) . 

An article of manufacture con^jrising a computer 
usable medium having computer program code means 
embodied therein for causing upgrading a software 
application from upgrade package files in a server 
(1) to a client (21a, 2lb, 21c) , the computer 
readable program means in said article of 
manufacture comprising : 

a) computer readable program code means for 
causing a computer to effect creating a copy of 
the upgrade package files on the server (1) ; 

b) computer readable program code means for 
causing a computer to effect creating an 
upgrade database table on the server (1) ; 

b) computer readable program code means for 
causing a computer to effect creating a pointer 
in the client's (21a, 21b, 21c) file on the 
server (1) pointing to the upgrade package 
files on the server (1) ; ' 

c) computer readable program code means for 
causing a computer to effect making the upgrade 
active; 

d) computer readable program code means for 
causing a computer to effect scanning the 
upgrade database table when a client (21a, 21b, 
21c) docks to determine the status of an 
upgrade with respect to the client (21a, 21b, 
21c) ; 

d) computer readable program code means for 
causing a computer to effect copying the 
upgrade to a client {2la, 2lb, 2lc) if the 
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client {2la, 2lb, 2lc) has not received the 
upgrade ; and 
e) computer readable program code means for 
causing a computer to effect invoking the 
upgrade at the client (21a, 21b, 21c) . 

The article of manufacture of claim 7 further 
comprising computer readable program code means for 
causing a computer to effect invoking the upgrade 
at the beginning of a client (21a, 21b, 21c) 
session. 

The article of manufacture of claim 7 further 
comprising computer readable program code means for 
causing a computer to effect invoking the upgrade at 
the end of a client (21a, 21b, 21c) session. 

The article of manufacture of claim 7 further 
comprising computer readable program code means for 
causing a computer to effect invoking the upgrade at 
the client's (21a, 21b, 21c) option. 

The article of manufacture of claim 7 further 
comprising computer readable program code meajis for 
causing a computer to effect invoking the upgrade 
at the server's (1) option. 

The article of manufacture of claim 7 further 
comprising computer readable program code means for 
causing a computer to effect creating a docking item 
file type to scan the upgrade database table when 
the client (21a, 21b, 21c) docks to thereby 
determine the status of an upgrade with respect to 
the client (21a, 21b, 21c) . 

A program storage device readable by a machine, 
tangibly embodying a program of instructions 
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executable by a machine to perform method steps for 
of upgrading a software application from upgrade 
package files in a server (1) to a client (21a, 21b, 
21c) said method steps coii:5)rising : 

a) creating a copy of the upgrade package files 
on the server (l) ; 

b) creating an upgrade database table on the 
server (1) ; 

b) creating a pointer in the client's (2la, 2lb, 
21c) file on the server (1) pointing to the 
upgrade package files on the server (1) ; 

c) making the upgrade active; 

d) scanning the upgrade database table when a 
client (21a, 2 lb, 21c) docks to determine the 
status of an upgrade with respect to the client 
(21a, 21b, 21c) ; 

d) copying the upgrade to a client (21a, 21b, 21c) 
if the client (21a, 21b, 21c) has not received 
the upgrade; and 

e) invoking the upgrade at the client (21a, 2 lb, 
21c) . 

The program storage device of claim 13 wherein said 
method steps further comprise invoking the upgrade 
at the beginning of a client (2la, 2lb, 2lc) 
session. 

The program storage device of claim 13 wherein said 
method steps further con^rise invoking the upgrade 
at the end of a client (21a, 21b, 21c) session. 

The program storage device of claim 13 wherein said 
method steps further comprise invoking the upgrade 
at the client's (21a, 21b, 21c) option. 
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17. The program storage device of claim 13 wherein said 
method steps further comprise invoking the upgrade 
at the server's (1) option. 

18. The program storage device of claim 13 wherein said 
method steps further comprise creating a docking 
item file type to scan the upgrade database table 
when the client (21a, 21b, 21c) docks to thereby 
determine the status of an upgrade with respect to 
the client (21a, 21b, 21c) . 
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